home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / blockcur.zip / BLOCKCUR.DOC < prev    next >
Text File  |  1989-08-29  |  11KB  |  214 lines
  1.  
  2. BLOCKCUR Copr. 1988-9 by Soapbox Software, PO Box 17998, Boulder, CO 80308.
  3.  
  4. BLOCKCUR creates a user-chosen cursor and then maintains that shape through TSR
  5. or terminate-and-stay-resident logic.
  6.  
  7.    A one or two-digit number after the command causes BLOCKCUR to wait about
  8. that many seconds before forcing the cursor into the desired shape.  This can
  9. cut the background processing required to maintain the shape of the cursor.  If
  10. you find your cursor changing shape too often, using an interval of zero forces
  11. the cursor into shape about 20 times a second; issue the command BLOCKCUR 0.
  12.  
  13.    Issue BLOCKCUR OFF to inactivate BLOCKCUR. Start BLOCKCUR with the /B switch
  14. if BLOCKCUR does not seem to work with your hardware; it will use your BIOS.
  15.  
  16.    Switches will produce cursors other than the default full block; use
  17.       /F   to get a full-height block;
  18.       /H   to get a half-height block;
  19.       /M   to get a middle-block;
  20.       /O   to get an overline cursor;
  21.       /T   to get a top half-high block; or
  22.       /U   to get an underscore cursor.
  23. The switch /Q reports the current state of BLOCKCUR, with no other action.
  24.  
  25. BLOCKCUR 1.08T Copr. 1988-9 by Soapbox Software, Box 17998, Boulder, CO 80308.
  26. After a week of free testing, contined use requires a ten-dollar license fee.
  27. ==============================================================================
  28.  
  29. Above is the information printed out in response to the command BLOCKCUR ? (the
  30. BLOCKCUR command followed by a question mark).  What follows is additional
  31. information for the curious or interested user.
  32.  
  33. A cursor is generated by a computer video card to let programs draw attention
  34. an important position on the display -- usually the position where the next
  35. character typed will appear.
  36.  
  37. Unfortunately, the cursor that is usually adequate on a CRT display can dis-
  38. appear on a display with less contrast, such as a liquid-crystal display (LCD)
  39. of the type commonly used on laptop or portable computers.  The same problem
  40. exists for some monochrome displays, since most programs are designed for
  41. high-contrast color displays.  Even a CRT user may wish for a more visible
  42. cursor.
  43.  
  44. BLOCKCUR addresses this problem, allowing the user to specify the size of the
  45. cursor, and then continuing as a resident program to prevent other programs
  46. from changing the shape chosen by the user. It takes less than 1K (1,024 bytes)
  47. of memory to do this, and allows changes of mind by the computer user with no
  48. additional cost in memory; further BLOCKCUR commands update the copy it finds
  49. already resident in the computer, so the user can experiment with various
  50. alternatives before settling on one.
  51.  
  52. Here are the parameters of the BLOCKCUR command.  All are optional, and the
  53. default values are given for each. They may be entered in any order.
  54.  
  55.  BLOCKCUR [interval][?][/Q][/F][/H][/M][/O][/T][/U][/B][/V][C=XY][/N][/W][OFF]
  56.  
  57. "interval" is the approximate number of seconds between the times that BLOCKCUR
  58. forces the cursor into the shape chosen by the user.  It is given as one or two
  59. decimal digits and varies from 0 to 99 seconds.  If 0 (zero) is specified, the
  60. cursor shape is updated as often as possible, approximately 20 times per
  61. second.  When BLOCKCUR is preventing cursor changes by monitoring the
  62. BIOS service call (Interrupt 10H, AH=1), running with a large value for this
  63. interval should work acceptably; therefore, 60 seconds has been chosen as the
  64. default value used if no value is entered.  However, if the programs you use
  65. do change your cursor shape (as they can do by writing directly to the
  66. video hardware), specifying a short interval should make the changes less
  67. noticable.
  68.  
  69. "?" generates a display of the information shown above.  No other action
  70. is taken if this parameter appears on the command line.
  71.  
  72. "/Q" (for "query") generates a report of the current status of BLOCKCUR.  If
  73. it is resident in memory, the report will indicate whether it is active or
  74. turned off; how many seconds the interval is set to; and the values being
  75. used for the top and bottom lines of the cursor.
  76.  
  77. "/F" specifies a cursor the full height of the character box.  This is the
  78. default value used if no cursor specification is entered.
  79.  
  80. "/H" specifies a cursor about half the height of the character box.
  81.  
  82. "/M" specifies a cursor occupying the middle half of the character box.
  83.  
  84. "/O" specifies a thin, line-sized cursor (an "overline") at the top of the
  85. character box.
  86.  
  87. "/T" specifies a cursor about half the height of the character box at the top.
  88.  
  89. "/U" specifies an underline cursor at the bottom of the character box.
  90.  
  91. "/B" specifies that BLOCKCUR should use the BIOS interface to your video card,
  92. rather than attempting to program the hardware itself.  Use this option if
  93. BLOCKCUR does not seem to have the desired effect on your machine.  Since
  94. the BIOS programs resident in your machine have been tailored to your machine's
  95. hardware, possibly they can do the job when BLOCKCUR finds the hardware
  96. incompatible.
  97.  
  98. "/V" specifies that BLOCKCUR should program the video hardware directly.  This
  99. is the default; you can use the flag to reverse the effect of the "/B" flag.
  100.  
  101. "C=XY" allows you to specify your own cursor. "X" represents a hexadecimal
  102. digit used to specify the top line of the cursor and "Y" another hexadecimal
  103. digit used to specify the bottom line.  (Hexadecimal digits are those used
  104. in the computer field to represent base 16 numbers, where the letters A through
  105. F stand for the decimal numbers 10, 11, 12, 13, 14 and 15, respectively.)
  106. BLOCKCUR is designed to work on CGA, EGA and VGA cards using the true cursor.
  107. If the cursor you select doesn't look right to you on your hardware, you can
  108. use this option to try to generate one that does.  You can also try for
  109. unusual effects.  On some display hardware, for instance, specifying the
  110. bottom line higher than the top line (such as C=D3) will produce a "split"
  111. cursor, with part of it at the top of the character box and part at the bottom.
  112. On other video cards, however, the result may be to make the cursor invisible.
  113. Experiment until you find something that works for you.
  114.  
  115. "/N" tells BLOCKCUR to allow other programs to change the cursor shape
  116. through the BIOS interface; by default, BLOCKCUR prevents use of this interface.
  117.  
  118. "/W" tells BLOCKCUR to keep other programs from using BIOS to change the cursor.
  119. You may want to use "/N" to allow other programs to change the cursor so you
  120. can see, for instance, whether an editor or word processor is in insert mode.
  121. If so, specify a short interval so that BLOCKCUR will change it back quickly.
  122.  
  123. "OFF" causes BLOCKCUR to turn itself off.  It remains resident in memory and
  124. can be turned on again with another BLOCKCUR command.  Just BLOCKCUR will be
  125. sufficient; the program will remember the options you have previously chosen.
  126. You might want to turn BLOCKCUR off if it is not compatible with another
  127. program you want to use.  (Since graphics modes do not show true hardware
  128. cursors, BLOCKCUR watches for programs entering graphics modes and turns
  129. itself off until the computer is set back to a non-graphics mode.)
  130.  
  131. (Note that turning BLOCKCUR off has no effect on the cursor; however, it
  132. allows other programs to modify the cursor without interference.)
  133.  
  134. The term "true hardware cursor" as used above here deserves some explana-
  135. tion.  The hardware cursor is generated by the video card that drives the
  136. display.  Since it is generated automatically by a part of the computer,
  137. there is no program overhead involved.  BLOCKCUR modifies the shape of this
  138. hardware cursor, but spends none of your computer processor time in making
  139. it appear, since that is a function of the hardware.
  140.  
  141. Some programs turn off the hardware cursor (which can be done by defining
  142. it to be very small -- starting and ending on the same line, for instance --
  143. or by positioning it off the screen) and generate a software or "virtual"
  144. cursor.  Programs that produce a non-blinking cursor or one that blinks
  145. faster or slower on demand usually do this through the "virtual cursor"
  146. approach, since the commonly a